The ESEServer class provides the ability to:
The full hierarchy of tasks can be introspected, starting with the ESECatalog. In this example we start the process of enumerating all folders, services and tasks by using an ESEServer object to get the catalog. Folders and services can be acquired by using the catalog object's methods. Similarly, tasks can be acquired from ESEService objects.
Server = ESE.GetServer( 'localhost', 8181 )
Catalog = Server.GetCatalog()
The ESEServer class has two convenience methods for finding tasks: FindTask() and GetTask(). If the URI of a task is not known then the task can be searched for using findTask(). This is also good if the task ever moves within the folder and services hierarchy.
Server = ESE.GetServer( 'localhost', 8181 )
Task = Server.FindTask( 'ese_addition' )
Regular expressions can also be used. In this example, all tasks with the substring 'ortho' in their name are found:
Server = ESE.GetServer( 'localhost', 8181 )
Task = Server.FindTask( 'ortho', /REGEX )
If the URI to a task is known, then GetTask() can be used to more directly specify and retrieve an ESETask object. Since there is a fixed root ("ese") and only one catalog (defaults to "services"), they are not specified.
Server = ESE.GetServer( 'localhost', 8181 )
Task = Server.GetTask( 'SyncService/ese_addition' )
When a service is in a folder, its tasks can be retrieved this way:
Server = ESE.GetServer( 'localhost', 8181 )
Task = Server.GetTask( 'MyFolder/MySubFolder/MyService/myFunTask' )
The name or IP address of the machine that is hosting the ESE server.
The port number that the ESE server is listening on.
The root endpoint for all ESE requests. This value is always 'ese'.
The URI up to and including the host, port, and root (for example, http://host:port/ese).
This method returns a hash that gives version information for ESE, IDL, ENVI, LiDAR, Mongoose, and SQLite.
Server = ESE.GetServer( 'localhost', 8181 )
info = Server.About()
Result = Obj.[ESEServer::]About()
Returns a hash with the following keys and values:
|
Key |
Example Value |
|---|---|
|
ESE |
Version 5.2.1 |
|
License Expiration Date |
1-apr-2015 |
|
Maximum Concurrent Jobs |
4 |
|
IDL Version |
8.4.1 (Jan 18, 2014) |
|
IDL Platform |
unix |
|
ENVI Version |
5.2.1 (Jan 18, 2014) |
|
LiDAR Version |
unavailable |
|
Mongoose Version |
5.4 |
|
SQLite Version |
3.7.13 |
This method returns !null on error.
None.
None.
This method downloads the resource specified by the given URL to the given file path. An array of URLs and matching files can be provided. The URLs must be valid and the file paths must be new files in writable directories.
This example downloads the file previously uploaded in the ESE::uploadFile example. Note that the destination path must be updated to be valid.
Server = ESE.GetServer( 'localhost', 8181 )
Server.DownloadFile( 'http://localhost:8181/docroot/ese/data_upload/boulder.tif', 'C:\Users\me\Desktop\boulder.tif' )
Obj.[ESEServer::]DownloadFile, URL, File
None.
The URL of the file to download. The ESE server can only download files that exist underneath its "docroot" directory. This argument can be an array of URLs. In that case, the File argument should be an array of corresponding destination file paths.
The destination to download the file to. This argument can be an array of file paths.
None.
This method searches for the given task and returns an array of ESETask objects. If the REGEX keyword is specified, then matches are performed using the name as a regular expression. The search is case insensitive.
Server = ESE.GetServer( 'localhost', 8181 )
Task = Server.FindTask( 'ortho', /REGEX)
Task = Obj.[ESEServer::]FindTask( Name [, /REGEX ] )
Returns one or more ESETask objects. If more than one match is found then the return value is an array of ESETask objects. If there is a communications error with the server then an error is thrown.
The name of the task to search for. Matches are case-insensitive.
Set this keyword to perform matching using Name as a regular expression. Matches are case-insensitive.
This method returns an object that represents the server's catalog. There is only one.
Server = ESE.GetServer( 'localhost', 8181 )
Catalog = Server.GetCatalog()
Catalog = Obj.[ESEServer::]GetCatalog()
This method returns an ESECatalog object.
None.
None.
This method returns the ESETask object at the given relative URI, which must start with a folder or service. The root and catalog are implied and must not be specified. Namely, the URI should be [folders/]service/task.
Server = ESE.GetServer( 'localhost', 8181 )
Task = Server.GetTask( 'SyncService/ese_addition' )
Task = Obj.[ESEServer::]GetTask( URI )
Returns an ESETask object that represents the specified task. If the relative URI is invalid then !null is returned.
A partial URI that is relative to the server's catalog. The server's root and catalog (typically 'ese' and 'services') are implied. The relative URI must begin with the folder or service that follows the catalog.
None.
This method checks whether the server is alive, returning !true or !false.
Server = ESE.GetServer( 'localhost', 8181 )
isAlive = Server.Ping()
Result = Obj.[ESEServer::]Ping()
This method returns !true if the server is responsive; otherwise, it returns !false.
None.
None.
This method uploads the specified file or files to ESE's "docroot/ese/data_upload" directory. The return value is the URI of the uploaded file (or an array, as appropriate). If the file already exists at the specified destination then it is overwritten. If there is a failure then an error is thrown.
file = filepath( 'boulder.tif', subdir = [ 'examples', 'data' ] )
Server = ESE.GetServer( 'localhost', 8181 )
uri = Server.UploadFile( file )
URIs = Obj.[ESEServer::]UploadFile( Files )
Returns the URI of the uploaded file or an array of URIs if an array of files was specified.
A scalar or array of file paths. Each specified file is uploaded to the "docroot/ese/data_upload" directory on the server and a URI to the file is returned for convenience.
None.
| IDL 8.4.1 | Introduced |